Summary

Adds support for QuickForm escalation channels (type: actionCenterQuickForm) to the low-code agent escalation tool. A QuickForm channel renders a schema-first FormLib task inline (no deployed Action Center app), while Action Center channels keep dispatching to their app task. The two variants are modeled as the upstream discriminated union EscalationChannel = AgentEscalationChannel | AgentQuickFormEscalationChannel and flow through the existing create_escalation_tool — no separate tool or factory branch. Channel configuration is validated up front at tool construction so malformed escalations fail fast at agent startup rather than mid-run.

Changes

• escalation_tool.py
  • create_escalation_tool consumes channel: EscalationChannel and handles both variants.
  • New module-level create_task_for_channel(client, channel, *, title, data, recipient, folder_path) -> Task concentrates per-channel dispatch: QuickForm → tasks.create_quickform_async(task_schema_key=schema_id, schema=form_schema, …); Action Center → tasks.create_async(app_name=…, …).
  • _resolve_channel(resource) resolves the channel and validates configuration at construction — a QuickForm channel missing its schema_id raises AgentStartupError(INVALID_TOOL_CONFIG) (previously a runtime AgentRuntimeError).
  • _try_get_channel_app_name(channel) derives app_name (Action Center → its app name; QuickForm → None), used for both WaitEscalation.app_name and the tool's display_name metadata (falls back to channel.name).
  • Form body is read via channel.properties.form_schema (the field; "schema" is its serialization alias) and the id via the schema_id property.
• ixp_escalation_tool.py
  • _resolve_action_center_channel(resource) validates that a VS escalation uses an Action Center channel, rejecting QuickForm with AgentStartupError(INVALID_TOOL_CONFIG). The narrowed type lets display_name read channel.properties.app_name directly (no lossy helper).
• pyproject.toml / uv.lock — bump uipath 2.10.74 → 2.10.79 (ships the EscalationChannel union, AgentQuickFormChannelProperties, and TasksService.create_quickform_async); package version 0.11.13 → 0.11.14.
• Tests
  • test_escalation_tool.py — TestQuickFormEscalation (dispatch to create_quickform_async, app_name=None in WaitEscalation, outcome-mapping END termination, tool metadata, Action-Center-does-not-dispatch-to-QuickForm) + construction-time missing-schema_id validation.
  • test_ixp_escalation_tool.py — display_name is the channel app name + VS escalation rejects a QuickForm channel at construction.
  • test_tool_factory.py — a QuickForm resource routes through the existing AgentEscalationResourceConfig path (no new factory branch).

Flow

flowchart TD
    A[create_escalation_tool] --> B[_resolve_channel]
    B -->|QuickForm without schemaId| E[AgentStartupError INVALID_TOOL_CONFIG]
    B -->|valid channel| C[tool invoked]
    C --> G[create_task_for_channel]
    G -->|actionCenterQuickForm| D[tasks.create_quickform_async]
    G -->|actionCenter| F[tasks.create_async with app_name]

Testing

• ruff check . + httpx-client linter — pass
• ruff format --check . — pass
• mypy on changed files — clean (remaining errors are pre-existing optional boto3/vertex extras, resolved in CI --all-extras)
• pytest tests/agent/ — 1177 passed
• Unit tests added/updated (QuickForm dispatch, construction-time validation, factory routing, IXP channel guard)
• Type-safe — no # type: ignore / suppressions added

Breaking changes

None — additive. QuickForm is a new channel variant; existing Action Center escalation behavior is unchanged.